This document describes the AppleScripts that are included in the DiskWarrior package and provides some guidelines for writing your own AppleScripts for use with DiskWarrior.
Contents
AppleScripts included with DiskWarrior
- Put Away DiskWarrior Items
- Quit the Finder
- Rebuild Directory
Writing Your Own AppleScripts For DiskWarrior
Dictionary for the DiskWarrior Suite
List of Errors Returned by the DiskWarrior Suite
AppleScripts included with DiskWarrior
Put Away DiskWarrior Items
DiskWarrior can create two new folders while rebuilding the directory. The first folder is the Damaged Items folder. It contains files with allocation errors or other errors which affect the data contained in the files. The second folder is the Rescued Items folder. It contains files and folders that were orphaned and/or recovered. Orphaned files and folders are items that were missing their enclosing folder. Recovered files are files that had an entry in an inaccessible portion of the directory. These files may have been previously lost or thrown away.
Review the DiskWarrior report you saved to determine which items in the Recovered Items folder were orphaned and which items were recovered. You must inspect the damaged and recovered files to determine which, if any, had missing contents. You can then replace, recreate or discard unusable files.
Once you have completed inspecting your files you can use this script to put good files back in their original enclosing folder. If you use the script on files in other folders, the files will be moved to whatever folder they were in before they were moved to their current folders.
To use this script, drag the files you want to put away onto the script.
Quit the Finder
Some disks are so damaged that they will cause the Finder to crash or hang. This script quits the Finder so that you can repair a damaged disk that causes problems for the Finder. You quit the Finder, open DiskWarrior and then insert your damaged disk. The Finder will relaunch automatically when you preview a replacement directory or when you quit all applications including DiskWarrior.
You use this script by double-clicking it.
Rebuild Directory
This script rebuilds the directory of one or more disks. You can use this script to rebuild a group of disks rather than rebuilding them one at a time.
To use this script, drag the disks you want to rebuild onto the script.
Writing Your Own AppleScripts For DiskWarrior
The best way to learn about writing your own AppleScripts for DiskWarrior is to modify one of the scripts that comes with DiskWarrior. For example, you might want to modify the Rebuild Directory script so that it always replaces the directory without displaying the report.
In addition to examining the included AppleScripts, you should review the AppleScript dictionary for DiskWarrior. You can view the dictionary by opening the Script Editor application, choosing Open Dictionary from the File menu, then selecting DiskWarrior.
When writing your own AppleScripts for DiskWarrior, remember that all commands sent to DiskWarrior and all information you wish to get from DiskWarrior must be inside a tell application block. For example:
tell application "DiskWarrior"
rebuild disk "My Documents"
end tell
An expanded listing of the DiskWarrior AppleScript dictionary is shown below for your reference.
Dictionary for the DiskWarrior Suite
rebuild: rebuild the directory of the specified disk
rebuild reference -- the disks to rebuild
[replacing yes/ask] -- specifies whether to show the report window before replacing the directory
[scavenging normal/always] -- specifies whether to scavenge the directory only when it would be normal to do so, or to scavenge even if it would not be normal to do so
Class application: An application program
Elements:
disk by name, by numeric index
Properties:
busy boolean [r/o] -- is busy rebuilding the directory of any disk?
last result integer [r/o] -- result of last rebuild
